home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / vvfont18 / vvfont18.doc < prev    next >
Encoding:
Text File  |  1992-11-15  |  8.9 KB  |  292 lines
  1. VVFont v1.8 Copyright (c) 1993, B. J. Traylor, Carrollton, GA
  2.  
  3.  
  4.  
  5.     VVFont is released as shareware, you are free to distribute this package
  6. in its entirety.  You may charge no more than $5.00 for duplication. No part
  7. of this package may be included with any other commercial package without the
  8. consent of the author.
  9.  
  10.  
  11.     In the spirit of shareware, the registration fee for this product is
  12. only $5.00.  You may try out VVFont without charge, but if you continue to 
  13. use it, please send your name, address and registration fee to:
  14.  
  15.                 B. J. Traylor
  16.                 2494 Hog Liver Road
  17.                 Carrollton, GA 30117
  18.  
  19.     All questions, comments, and suggestions for improvements will be
  20. appreciated.
  21.     I can be contacted on Compuserve at 71730,337.
  22.     I usually log on on Friday or Saturday after midnight, so check after then
  23. for an answer.
  24.  
  25.  
  26.     VVFont is a .chr to .v font string converter designed for use with Vivid,
  27. Polyray, and Persistence of Vision.
  28.  
  29.     VVFont reads Borland's chr stroke fonts and writes scripts for Stephen
  30. Coy's Vivid, Alexander Enzmann's Polyray, and Persistence of Vision.
  31.  
  32.     VVFont creates a file with fonts changed into raytrace primitives.  Fonts 
  33. are created with the width along the X-axis and the height along the Y-axis. 
  34. Output is created in 2 basic styles--Round and Square. Square letters with no 
  35. depth make Flat letters. Square letters with different top and bottom radii 
  36. (radii are used because the ends of the strokes are cones and rings) make 
  37. Tapered letters.
  38.  
  39.     With the release of version 1.7 of VVFONT, I have added Beveled letters
  40. and Domed letters.  
  41.     Beveled letters are square letters with flat tops and 45 degree bevels 
  42. along the sides.  Beveled letters must have a bottom radius greater than 
  43. the top radius.
  44.     
  45.     Domed letters are round letters with flat sides that extend back to the 
  46. depth of the letters.  The domed letters can have sloped sides by making the
  47. top radius different from the bottom radius, however, the bottom radius must
  48. be greater than zero. The depth must be greater than or equal to the radius.
  49.     
  50.  
  51.  
  52.     Version 1.7 of VVFONT adds a command file processor. This will read a 
  53. simple ASCII file and process it according to VVFONT's input rules. The 
  54. following commands may be used:
  55.  
  56.     FONTFILE <font filename>          
  57.     OUTPUTFILE <output filename>
  58.     TRACER <raytracing program>
  59.     STYLE <style type>
  60.     DEPTH n.nnn
  61.     HEIGHT n.nnn
  62.     WIDTH n.nnn
  63.     TRADIUS n.nnn
  64.     BRADIUS n.nnn
  65.     XOFFSET n.nnn
  66.     YOFFSET n.nnn
  67.     ZOFFSET n.nnn
  68.     TEXTURE <texture string>
  69.     STRING <string to convert>
  70.  
  71.     where n.nnn is any valid floating point number.
  72.         <font filename>: Any valid Borland stroke font.
  73.         <output filename>: Any valid DOS file name.
  74.         <raytracing program>: Vivid, Polyray or dPersistence of Vision
  75.                 (VVFONT only reads the first character [V, P or D]).
  76.         <style type>: Round, Squared, Beveled, Domed (R,S,B,D).
  77.         <texture string>: Any string.
  78.         <string to convert>: VVFONT will read from the next valid non-blank 
  79.             character to the end of the line.
  80.  
  81.     VVFONT is not case-sensitive.  You may use either upper or lower characters
  82. in the command file.  You may also place comments in the command file by 
  83. preceding the comment with two slashes (//).  Everything after the slashes in
  84. that line will be ignored.
  85.  
  86.  
  87. //example command file:        
  88.     FONTFILE SIMP.CHR
  89.     OUTPUTFILE STRING.VO
  90.     TRACER V                      // Vivid raytracer
  91.     STYLE B                       // Beveled letters
  92.     DEPTH 1.5
  93.     HEIGHT 5
  94.     WIDTH 5
  95.     TRADIUS 0.5                   // Top radius
  96.     BRADIUS 0.75                  // Bottom radius > Top radius
  97.     XOFFSET -6.25
  98.     YOFFSET 0
  99.     ZOFFSET 1.5                   
  100.     STRING Any string at all.     // Kern with « or »
  101.  
  102.  
  103.     Use a command line argument to tell VVFONT the name of the command file 
  104. when you start VVFONT:
  105.  
  106.     VVFONT <command file name>
  107.  
  108. example:
  109.  
  110.     VVFONT MASTER.VVF
  111.  
  112.  
  113. If VVFONT doesn't find some information it needs, it will ask for it.
  114. Use this feature during testing. Leave out the line(s) you want to change
  115. for subsequent runs and leave in the constant information. (You may also
  116. comment out the lines)
  117.  
  118.  
  119.  
  120. Enter font filename :
  121.     Name of Borland stroke font (example: LITT.CHR)
  122.  
  123. Enter output filename :
  124.     Name of output file (if file exists, user will be given choice of Appending,
  125.     Overwriting, or Exiting program) (example: FONTPIC.V)
  126.     Pressing Enter without supplying a filename will send information to the
  127.         screen.
  128.  
  129. Enter tracer name :
  130.     Name of raytracing program you use. 
  131.         (VVFont only reads the first character)
  132.             V for Vivid 
  133.             P for Polyray
  134.             D for Persistence of Vision (P and V were already used)
  135.  
  136. Enter letter style :
  137.     R for rounded (cylinder strokes)
  138.     S for squared (squared strokes), also for Flat with depth of 0
  139.     B for beveled (squared strokes with a bevel)
  140.     D for Domed (cylinder strokes with flat sides)
  141.  
  142. Enter depth :
  143.     Any depth >= 0.0   (0.0 gives flat letters with no sides or back).
  144.     You get this question only if you select Square letters.
  145.  
  146. Enter letter height :
  147.     Any size greater than 0.0 (Example: 5.0)
  148.  
  149. Enter letter width :
  150.     Any size greater than 0.0 (Example: 5.0)
  151.     This number is not the actual width.  For standard letters, this number
  152.         should be the same as the letter height. If smaller than the letter
  153.         height, letters will be tall and thin.  If larger than the letter
  154.         height, letters will be short and squat.
  155.  
  156. Enter radius :
  157.     Any size greater than 0.0 (Example: 0.5)
  158.     This is the size of all the strokes (which are made up of spheres and cones
  159.         in Round syle letters. Square style letters are made up of rings, cones
  160.         and polygons.  Flat letters (Square letters with depth of 0) are made up
  161.         of rings and polygons.)
  162.         A good starting radius for Simp letters is 1/10 of the height.
  163.         A good starting radius for Goth letters is 1/100 of the height.
  164.         Try 1/50 for Trip.
  165.  
  166. Enter bottom radius :
  167.     Any size greater than 0.0
  168.     This should be the same as the top radius to give sides that are
  169.         perpendicular to the face and back.
  170.     If this is greater than the top radius, the sides will splay out away from
  171.         the face.
  172.     If this is less than the top radius, the sides will go under the face.
  173.     For Beveled letters, this must be greater than Top radius.
  174.  
  175. Enter X offset :
  176.     Any amount (Example: -2.5)
  177.     All output defaults to be left-justified to 0.0
  178.  
  179. Enter Y offset :
  180.     Any amount (Example: 10)
  181.  
  182. Enter Z offset :
  183.     Any amount (Example: 0)
  184.  
  185. Enter texture name :
  186.     Enter name of texture for letters (For Polyray or Persistence of Vision)
  187.     (Example: shiny_red)
  188.  
  189. Enter string to convert :
  190.     Any string using letters in the font that you want in your scene.
  191.     Manual kerning can be accomplished by entering double arrows ( « or » )
  192.     pointing in the direction you wish to move the following character.
  193.     « is created by holding down the Alt key, typing 174, and releasing Alt.
  194.     » is created by holding down the Alt key, typing 175, and releasing Alt.
  195.     Each kern is 1/25 of the width. 
  196.     Example:
  197.         
  198.         W««««A««««YN»E
  199.     
  200.     This adjusts the awkward spacing between the letters in some fonts.
  201.  
  202.  
  203.  
  204. The information at the beginning of the output file can be used for starting
  205. up your scene.  The studio/viewpoint information provided is for a
  206. straight-on view at 45 degrees. These should be good starting points, use
  207. your imagination for best results.
  208.  
  209. The output file separates the tops, the bevels, the sides, and the backs so 
  210. you can change the surfaces of each with little trouble. (This appeared in
  211. version 1.4, but I forgot to put it in the documentation until version 1.7)
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218. This package contains :
  219.       VVFONT18.EXE
  220.       VVFONT18.DOC
  221.       VVLOGO.BAT
  222.       VVFONT.V
  223.       VV.VVF
  224.       FONT.VVF
  225.       POV.VVF
  226.  
  227.  
  228.  
  229. Additions in version 1.2:
  230.  
  231.     Squared (and flat) letters
  232.  
  233.  
  234.  
  235. Changes in version 1.3:
  236.  
  237.     Squared letters with different front and back radii (Splayed letters?)
  238.  
  239.  
  240.  
  241. Changes in version 1.4:
  242.  
  243.     Improved output file.
  244.     Squared letters have Tops, Sides, and Backs sorted in the output file so
  245.         they can be given different surfaces.
  246.  
  247.  
  248.  
  249. Changes in version 1.5:
  250.  
  251.     Added support for Polyray.
  252.     Fixed bug that added redundant objects at end of file.
  253.  
  254.  
  255.  
  256. Changes in version 1.6: (never released)
  257.     
  258.     Added support for command file processor.
  259.  
  260.  
  261.  
  262. Changes in version 1.7:
  263.  
  264.     Added Beveled letters.
  265.     Added Domed letters.
  266.     Added manual kerning.
  267.  
  268.  
  269. Changes in version 1.8:
  270.  
  271.     Added support for Persistence of Vision 1.0.
  272.     Changed file processor to not change texture to uppercase, and to allow
  273.           multiple-word textures.
  274.  
  275.  
  276.  
  277. Questions and answers:
  278.  
  279.     Q: Why do I have trouble with the letter 'e' in GOTH.CHR?
  280.     A: I don't know why, but here's how to fix it.
  281.             Start Borland's font editor.
  282.             Load GOTH.CHR
  283.             Select GLOBAL
  284.             Select LeftSpace
  285.             Select 1
  286.             Exit
  287.             Save GOTH2.CHR
  288.         Use GOTH2.CHR for your gothic style letters. (If you look at the 'e'
  289.             you will notice that it moved 2 spaces to the right while all the 
  290.             other letters moved 1.)
  291.  
  292.